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Steve Wozniak, designer of the Apple II is no longer involved in any Apple 
projects, although he remains an employee on a consulting basis, according to 
Linda Merrill, Apple II specialist in Apple's corporate relations department Steve 
is starting a home video products company, which will develop products that will 
allow consumers to use video cassette recorders in new ways. Wendell Sander, 
head hardware designer for the Apple III, has reportedly joined Steve, but that is 
unconfirmed. 

According to the Wall Street Journal (Feb 7, p. 42), Wozniak told reporters that 
his departure was prompted in part by bitter disagreement with Apple's manage- 
ment over the company's direction and by frustration with the rigidity of a big 
corporate bureaucracy. Wozniak said the Apple II "has been ignored in the hope 
that it will die and go away." 

Steve's new products have "nothing to do with home computers," according to 
Merrill. Steve has always been a vocal spokesperson for Apple II users inside 
Apple itself. Although he is still "officially a part of Apple", his absence on a full- 
time basis is a blow to those of us already concerned about the relatively 
minuscule development investment Apple makes in its Apple II family. 

Apple's annual stockholder's meeting, held on January 23 this year, was a 
Macintosh circus. Hot one of the new products announced works with the Apple II. 

Apple did announce, however, that by fall it would have a peripheral card for the 
IBM PC that will allow connection to Applelalk— its new low-cost system for 
hooking {non-Apple II) personal computers, printers, large memory devices, and 
other peripherals together. 

Apple spokesperson Merrill tells us Apple is aware that many Apple II users, 
particularly in educational institutions, are interested in this capability and she 
assures us that Apple is working on it 

Meanwhile, AppleWorks was December's sales leader in retail stores, 
according to Infocorp, a market research firm in Cupertino. The program walked 
away with 17 per cent of all software sales. The much ballyhooed Lotus 1-2-3 was 
in second place with just 10 per cent of the market 

Quote of the month: 

/ would argue that the ultimate deciding factor in computer obsolescence is 
software availability, The sure sign of a computer growing into obsolescence is 
that no new software is being developed for it. And if software is available to do 
what you want done with your computer, it wiii not be obsolete for quite some 
time. (By this measure, the Apple II may never be obsolete.) 

The quote is from Mark Wilsdorf, editor of AgriComp (103 Outdoors Bldg, 
Columbia, MO 6520X $24/yr), a well-done magazine that covers the area where 
agriculture and personal computers overlap. Much of the magazine's material is 
based on spreadsheet templates that work with any kind of computer. If you are 
one of the world's unfortunate souls involved in agriculture, you should get this 
one, depression or not 

New enhanced ROMs for the Apple He have been mentioned in various press 
reports the last few weeks. The new ROMs reportedly make the He and lie more 
compatible. When Apple officially introduces these new ROMs we'll have a com- 
plete report (and if it's not by March 15, the April Open-Apple may be mostly 
blank). 



Basham fires up the Incinerator 

I got a letter and disk from Bill Basham, developer of Diversi-DOS {arch- 
competitor of my own ProntoDOS ) this month: 

your discussion of garbage collectors in the January issue inspired me to 
finally write one. I've enclosed the latest Diversi-DOS update, which includes a 
48ft and a 64ft garbageman on it 

I hereby donate the 48ft garbageman to the public domain. Since the 64ft 
version works only with Diversi-DOS, I will retain the rights to it There's also a 
source listing for the 48K garbageman for you to publish if you wish. Of course, 
I used the Pascal assembler (ed note: expletive deleted), so you may have to do 
some retyping and possibly add some improved comments. Feel free to make 
up a catchy name for it 

My garbageman may be a little slower, but I'm confident that it is the world's 
smallest That should make it ideal for publication, and I hope will make that 
issue a hot one. 

Bill apparently wants me firmly entrenched in the newsletter business and out 
of the DOS-enhancement business. After looking over his program I am inclined 
to give up trying to compete with him —this is a masterpiece. 

Readers of our January issue will remember a two-page spread on how to avoid 
garbage collection — the malady that strikes string-intensive Applesoft programs 
at the most inopportune times. FroDOS solves the problem by including its own 
high-speed garbage collector. Piow DOS 3.3 users also have a high-speed garbage 
collector that fits entirely within DOS. As with ProDOS, however, you have to give 
up the ability to initialize disks. 

Basham's program, hereby christened the Incinerator, works by making a 
temporary copy of the standard Applesoft garbage collection routine and mod- 
ifying it The copy is placed in the DOS "nibble buffers ", a rather large memory 
area that gets overwritten whenever a disk is accessed. Since the disk is inaccess- 
ible while the routine is running, however, it's a nice safe place to go to bum the 
garbage. 

The modifications cause the old garbage collector to use two new routines at 
critical places, These routines, as well as the code that moves and patches the 
old garbage collector, resides in the DOS area normally used by the init com- 
mand. The program begins with a third section that installs the main body inside 
DOS. 

Here's the speed comparison from our January article with Incinerator timings 
added: 

Garbage collection time 
in seconds 



number of 
strings 

250 

500 

1000 



DOS 3.3 

5 
19 
114 



Incinerator 

0.7 

1.5 

4.0 



ProDOS 

0.1 

0.2 
0.5 



For those of you interested in such stuff, the complete source code for 
Basham's Incinerator follows. You can study it with the help of the comments I've 
written. If all you want to do is use it you can type it in by hand. However, if you 
have a modem, software that allows you to capture files, and access to Compu- 
Serve, you can also download it from the Micronetworked Apple User Group 
library {GO FCS-51). It's filed in the "Apple II Hacking'' section. Select brouse from 
the menu that appears and enter //YC//YE/OTO/?when you are asked for a "/key". 
(All of the other programs in the first three issues of Open-Apple are also now 
available in the MAUG library.) 

Basham's original version — the one that now comes with Diversi-DOS— is 
connected to the Applesoft ampersand hook. I have modified the version pub- 
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lished here so that it is called automatically by DOS every time a carriage return 
is printed. On each call the amount of unused memory left is checked If there j 
is more than about IK, control quickly returns to DOS. If mere is less, collection 
occurs automatically. 
To force collection, use the following command: 

POKE 48816,0 : PRINT : POKE 48816,1 

The complete source code follows: 



>LNa.2 




If you want to type in the tncimrstor by hand rather than 
CompuServe, the easiest way js£> antef the material in the gray 

Mcftttor commands we've covered in last month's issue and in tWs 
Check your ehtrfes using the ifenrtor's l(isf) command. Then enter 
m tNCmmrm mm, iStS&ro execute the program, enter &fWi 



INCINERATOR 

Fast garbage collector for 4BK CDS 3.3 

By Bill Basham, Diversified Software Research 
January 19B5 

Comments and 005 hooks by Tom Weishaar 

A public domain program 



.OR ! 
.TF INCINERATOR 



0046: 
005E: 
006D: 
00GF: 
0073: 
006A: 
00BF: 
0098: 

0300: 
9D1E: 
AEBE: 
BEAF: 
FDEO: 



B8E4: 

BB21: 
BBS?: 



E4B4: 



0022: 

AEBE: 
AEB0: 
AED2: 

BC11: 
BC33: 



COUNTER 

INDEX 

5TREND 

FRETDP 

MEMS I Z 

FNCNAM 

DSCLEN 

LDWTR 



.Eg $46 
.EO $5E 
.EQ $60 
•EO $6F 
.EQ $73 
.EQ $BA 
.EQ I8F 
-EO $36 



the lower edge of string space 

neu strings are stored from here down 

the upper edge of string space, HI MEM 



P3.D05WARM .EQ $3D0 page 3 vector 



.EO $9D1E INlT's entry in DOS and jump table 

.EQ SAE8E File Manager's INIT instruction area 

.EQ $BEAF RWTS's 1N1T instruction area 

.EQ $FDED Monitor's print-character subroutine 

(JE484) Addresses of F P. GARB 
(SE4BC) entry points after 
(JE552) relocation in DOS 
($ES68) nibble buffer. 



INITADR 
FW.INIT 
RWTS.INIT 
COUT 

MOD. GARB .EO 
MOD. CONTINUE .EQ 
MOD. CHECK. BUMP .EQ SBBCE 
MOD.MOVEUP .EQ SBBE4 



MOD.RELQ 

MOD.PTCH.2 

M0D.PTCH.1 

FP.GARB 



.EQ $BB21 ($E4A5) Points where M DO. GARB 

.EQ SBBS2 (JE4DG) must be changed due to 

.EO $BBBE ($ES42) relocation. 

.EQ $E484 Address of original garbageman 



* INCINERATOR'S string address buffers 



NSTR .EQ 34 n of strings collected Dn each pass (34 max) 



DSC. ADR. LO .EQ FM. INIT 

OSC.ADR.HI .EQ D5C.ADR.L0+NSTR 

DSCLEN .EQ DSCR0R.HI+N5TR 

STR.ADR.LD .EQ tflCll 

STR.ADR.HI .EQ STR.ftDR.LO+NSTR 



FM. INIT area (AEBE-AF07) 
is used to save string 
variable table pointers. 

Left-over part of nibble buf 
is used for string pointers; 
ends at 5BC56, thus 34 max 



* INCINERATOR'S installation routines 



4tt*iB 

m 

400?:79 Dl «3 



CHECK. DOS 
CLC 

LDA M00 

ldx ttsee 

LDV «$01 
.1 ADC P3.DDSURRM+1,Y 
8CC.2 
I NX 



First, check to make sure DOS 
hasn't already beBn modified. 
Installing the INCINERATOR 
over an existing DOS patch 
could damage disks. 

Check is made by simply adding 



together the first two bytes 
in each area to be mod if Led 

ing the result with 
5 3.3 result. 

If DOS has been moved to the 
language card area, or if 
program is run under ProDOS, 
inclusion of page-3 uarmstart 
vector (see $4007) uill cause 
check to fail. 



DOS ok, begin installation below. 
Can't execute; DOS modified. 
Save DOS stack pointer while 
printing error i 




Point INIT entry in DOS command table to an 

RT5--D0S INIT command nou does nothing. 
Disable RWTS 'format' 



Move INCINERATOR routines tD area normally 
used by the RUTS init command. 



Install hook in DOS- Putting hook at I9F2C 
means INCINERATOR will be called whenever 
a <return> is printed. 



JMP RWTS.INIT Hook to our routines; moved to $9F2C 



* INCINERATOR main body 

* These routines are moved into the RWTS INIT space and 

* are called by DOS every tine something is printed. 




TEST. GARB 
LDA M04 
BEQ INCINERATE 

CLC 

ADC 5TREND+1 
CMP FRET0P+1 
BCS INCINERATE 
DONE 

JMP S9FA4 



Main entry point. First check to 
garbage needs to be collected. If 
lots of space is left, don't proceed 

The $04 at $40C6 means collection 
occurs only if there is less than 
IK free. Change it if necessary. 

Return to DOS to continue output. 



if 
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INCINERATE 

These routines move a copy of Applesoft's original 
garbage collector into the DDS nibb-le buffers, patch it 
so that it calls new routines at two critical places, 
and then jumps to the new version. 





INCINERATE 

LDY M13 
.1 LDA FP.GARB+SFF.Y 

5TA MOD.GARB+JFF,Y 

DEY 

BNE .1 
.2 LOP FP.GARB.Y 
STA MOD. GARB, V 
I NY 

BNE .2 

■ TYfl 

LDY HNSTR-1 
5TV COUNTER 
.3 STfl STR.ADR.HI ,Y 
DEY 

BPL .3 



FP.GRRB Is Applesoft's original garbage 
collector. First ue move it into the 
DOS "nibble buffers" at $BB00~8CS5. 
These are overwritten on all DOS 
calls, but we can use them for a 
moment here. 

MOD. GARB is what we call the new 
location, since the new copy will be 
patched by the routines below. 



Initialize COUNTER with the number of 
strings (minus 1) and fill the string 
address buffer with zeros. 



LDY H$03 
.4 LDX RELOCATION. TABLE, Y 
LDA RELOCATION. TABLE+4.Y 
5TA MOD.REL0,X 
LOA 8$8B 
5TA MOD.REL0+l,X 
DEY 

BPL .4 



LDY 8$02 
.5 LDA PATCH. HOOK, Y 
STA MQ0.PTCH.1,Y 
LDA PATCH. H00K+3,Y 
STA MDD.PTCH.2.Y 
DEY 
BPL .5 

JMP MOO. GARB 



Modify GARB in two places so that it 
jumps to our new patch routines 
rather than doing things the old 
FP way. 



Jump to the newly modified garbage 
collector. 



BF03: RELOCATION. TABLE .EQ *-TE5T.GARB+RWT5. INIT 

.HS 80.ig.70.EF.9F.95.9F Data needed for relocation. 

Patch for original move-string routine. 

PATCH. HDOK .EQ *-TE5T.GARB+RWTS. INIT 
JMP SAVE. ADRS 
JMP MOVE. STRINGS 

* MOVE. STRINGS is called by our modified garbageman 

* after a complete scan of the string variable 

* tables has been completed. 

* 

BF11: MOVE. STRINGS .EQ * -TEST. GARB+RWT5. INIT 

* 

* First find the highest address in our buffer. 



A12P-M 22 
4129*8$ 46 ' 




413F-;W:02 




. 



LDA tINSTR 

STA COUNTER 
FIND. HIGH 

LDX ttNSTR-1 

LDY WNSTR-2 
HI. CHECK 

LDA 5TR.ADR.HI,Y 

CMP STR.ADR.HI,X 

BCC NXT.HI 

BNE NEW. HI 

LDA STR.flDR.LO.Y 

CMP STR.ftDR.LO.X 

BCC NXT.HI 
NEW. HI TVA 

TAX 
NXT.HI DEY 

BPL HI. CHECK 



Initialize counter with the number of 
strings our buffers will hold. 

X is first adr; becomes the highest found. 
Y points to the adr under study. 

Compare current to highest found so far. 

Current is less. 
Current is greater. 

Can't tell, test low byte. 

Current is less, next please. 

Current is greater, move current 
pointer to X. 
Continue until entire buffer has been 
scanned; X then points to highest 
string in buffer. 



* Pass this address to a section of the 

* original garbage collector for moving. 



4146:80 

4mM 




LDA 


STR.ADR.HI ,X 


Get highest adr 


BEQ 


DONE 


If zero, we've moved them ail. 






Collection complete, return to DDS 


STA 


LOWTR+1 


Pass it to MOD. GARB 


LDA 


5TR.A0R.L0,X 




STA 


LOWTR 




LDA 


tt$00 


Remove this address from buffer 


STfl 


STR.ADR.HI,* 




LDA 


DSC. ADR. HI, X 


Pass the descriptor address and length 


STfl 


FNCNAM+1 


to MOD. GARB 


LDA 


DSC.ADR.LO,X 




STfl 


FNCNAM 




LDA 


DSC.LEN.X 




J5R 


MOD.MOVEUP 


Tell MOO. GARB to move it. 



* Repeat until everything in buffer has been moved. 



Adjust four adrs within MOD. GARB 
that must change because it's 
been moved. 

($8B is the correct high byte 
for all relocated adrs.) 



4167:86 6F 
4169585 70 
41G0;C6 46 
4160:00 BC 




STX FRETDP 
STA FRET0P+1 
DEC COUNTER 
BNE FIND. HIGH 

LDY RNSTR-l 
STY COUNTER 
JMP MOD. CONTINUE 



Adjust FRETOP 

Continue until all adrs 
in buffer have been moved. 

Reset counter for SAVE. ADRS 
And continue search. 



SAVE. ADR is called when MOD. GARB has found a string higher 
than the lowest string found so far. SAVE. ADR saves 
the address of the string and its variable-table 
descriptor address and length in our special buffers. 

The new string's addresses overwrite those of the lowest 
string found up till now. 

Afterwards, a scan is made of the buffers to redetermine 
the address of the lowest string found so far. 
The address of that string is passed to MOD. GARB 
and the pointer to it is saved so that any higher 
string found will overwrite it. 



BF60: 



41?6.:A4 46 : 
4170:99 33 BC 
4l7fl:0A 

4i7T:A5 ST- 
4181:99 80 At 
4J84:A5 $E 

4186:99 02 AE 



4l8Erft2:21 




4i'8ii8$- eC : 



4185586 46 
4187:4C CE 88 



5AVE.ADR5 .EQ *-TEST 
LDY COUNTER 
STA STR.ADR.HI ,Y 
TXA 

STA STR.ADR.LO.Y 
LDA INDEX+1 
STA DSC. ADR. HI, Y 
LDA INDEX 
STA DSC.A0R.L0,Y 
LDA DSCLEN 
STA D5C.LEN,Y 

LDX ttNSTR-1 

* 

LOY ttNSTR-2 
LOU.CHK 

LDA STR.AOR.HI,X 

BEQ LDONE 

CMP STR.ADR.HI,Y 

BCC NXT.LOW 

BNE NEW. LOW 

LDA STR.ADR.LO,X 

CMP STR.ADR.LO.Y 

BCC NXT.LOW 
NEW. LOW 

TYA 

TAX 
NXT.LOW 

DEY 

BPL LOU.CHK 

LDA STR.ADR.LO,X 
STA LOWTR 
LDA STR.ADR.HI,X 
STA LOWTR+1 

LDONE 

5TX COUNTER 

JMP MOD. CHECK. BUMP 



.GfiRB+RWTS.INIT 

Get current index to adr-save buffers. 
High byte of string adr in A; store it. 
Low byte of string adr in X; store it. 

High byte of descriptor address was in 

INDEX+1; store it. 
Low byte of descriptor address was in 

INDEX; store it. 
Descriptor length; 
store it. 

X starts as ptr to first adr in buf; 

becomes ptr to lowest adr in buf. 
Y is pointer to adr now under study. 

Compare current low to adr under study. 
If current low is zero, exit. 

Current low is lower, next please 
New adr is lower, point to it with X 

Can't tell--test low byte. 

next please 

Move pointer aimed at current adr to 
pointer for lowest adr 

Check next adr in buffer till 
there aren't any more... 

Then take the lowest address we have in 
the buffer so far and put it in LDWTR, 
so MOD. GARB will call us if it finds 
any higher strings. 



Save ptr to lowest string as new index. 
Return to MOD. GARB to continue search. 
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A Song Continued 



I into the murky depths of the Apple Monitor last month, 
examined memory as a dump of hexadecimal values, as machine language code, 
and as ASCII characters. I explained how to change the contents of any memory 
byte from one hex value to another. While these are the most common uses of 
the Monitor, it can also do other useful and interesting things. 

The Monitor was actually designed as an assembly-language-program debug- 
ging aid. nowadays— nearly a decade after Wozniak designed it— much better 
debuggers are available, nonetheless, the fact that this one has been built into 
every Apple ever manufacturered makes its features worth further investigation. 

It is difficult to stamp out all the bugs in assembly language programs without 
some way to stop the program at trouble spots and see what's happening. The 
standard method for doing this is to use the oreafc instruction. The machine 
language code for a break is $00. To see what happens when this instruction gets 
executed, let's put one at address $300 and jump to it Here's how 



0300- 00 02 00 00 00 00 00 00 



[press return to check) 



(beep) 



0302- 



fl=00 %m Y=00 P=30 S=F0 



When you enter 300G, your Apple executes the break instruction we just put at 
that address. This causes a "crash" back into the Monitor. You will hear a beep and 
see a one line display that begins with an address. The address is always two bytes 
beyond the location of the crash-inducing break instruction. The rest of the line 
shows you the status of your microprocessor when the break occurred The 6502 
microprocessor found in Apples has five special memory locations, called regis- 
ters, that do all the work. These are called the A, X, Y, F, and S registers. The display 
shows what values were in these registers when the break occurred. 

After a break, you can List your program or examine memory. If you need to refer 
back to what the contents of the registers were when the break occurred, you can 
do so with the control-examine) command, like this: 



(press control -E, return) 



A=20 X=00 Y=00 P=30 S*F0 



You can also load the registers with any desired values before executing a routine 
by using control-E, entering a colon and the desired memory values, and Going to 
the desired routine. In the following example, we put new numbers in the A, X, and Y 
registers and jump to our break instruction to see if the/ re really there: 



(press control-E, return) 



A=00 X=00 V=00 P=30 5=F0 
*:11 22 33 





••••/••;•'.• 



*^ cum***. rrwriHw st<;**« ^ ^«^>>' '\ f V (Q 

rmm Attn**** 4* <vr&* af 




i *T listing rsn$8 of Memory into 
v anp ther f*nge; *t pw») •* r-? - 



-n : M |W) fx 
{.to} < ff^sti^tj . 




>CALL -2458 
'$300. 30T 



(beep) 

(S means this is a Monitor command) 



0300- 00 02 ( 



"300G 

302- 

1 



fell X=22 V=33 P=30 5=F0 



Mote: unlessyou know whatyou're doing, don'ttrytochange the contents of theP 
or S registers. The effect can be dramatic 

Meet Mini. The Monitor program built into the original Integer Basic Apple II 
also had commands for stepping through and tracing machine language pro- 
grams, as well as a Mini-Assembler. The Mini-Assembler allows you to enter a 
program in assembly language. It still exists in the Integer Basic image on DOS 3.3 
System Master disks, but the S(tep) and T{race) commands are unavailable to all 
but a few old-timers. 

The Mini-Assembler is useful for entering short and quick assembly language 
programs. 1 1 doesn't have many of the features of a full-blown assembler, however 
(such as labels, equates, and assembler directives), so its usefulness is limited. 
To get it running, boot a DOS 3.3 System Master disk and enter the fnt command 
to get into Integer Basic Then call -2458 (or drop into the Monitor and enter 
F666G). 

The Mini-Assembler prompt is the exclamation point All Monitor commands 
work within the Mini-Assembler if you start a line with a dollar sign. To begin an 
assembly,entertheaddressatwhich you wantthe machine langagetogo.acolon, 
and a mnemonic 



■300:LDA HCF 

m cf 



LDfi WCF 



(start adr, colon, instruction) 



(note 



before JSR) 



! JSR FDE0 
0303- 20 E0 FD JSR JFDED 

To get out of the Mini-Assembler, press reset 

Enhanced RON enhancements. The Mini-Assembler can also be found in the 
new enhanced ROMs for the Apple He. You can start up this version of the Mini- 
Assembler directly from the Monitor by entering an exclamation point 

The enhanced He ROMs also have a new search command that finds all 
occurrences of a one- or two- byte value in a specified memory range. The 
command for finding two sequential bytes with the values $ED and $FD in the 
range from $F800 to $fflT is FDEIKF800.FFFFS. Mote that the value to be 
searched for is entered backward (which makes forward if you're looking for an 
address pointer that's stored backward) and that the line ends with an "S". You 
can also search for a single byte ( ECKF8O0.FFFFS), but you can't search for a two- 
byte pair if the first byte is a zero. 

The He's Monitor, although otherwise similar to the Monitor in the enhanced 
He ROMS, doesn't have these features. On the other hand, the He Monitor's list 
command (examined last month) correctly disassembles the additional com- 
mands in the 65C02 microprocessor's instruction set this is something neither 
He Monitor can do. 
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Wore Commands. There are several fairly useless commands available from 
within the Monitor. W(rite) and R(ead) are used to save and recall ranges of memory 
to and from cassette tape. The I !c is missing these commands since it doesn't have 
a cassette interface. 

Still around in all versions of the Monitor, but of little value since the introduction 
of DOS, are the control-B(asic), control-Qontinue Basic), control-F(rinter), and 
control-K(eyboard) commands. Control-B will coldstart Basic, jumping out of the 
Monitor and erasing any Basic program in memory, Control-C also jumps from the 
Monitor to Basic, but does a warmstart and leaves any Basic program intact To 
keep DOS active, 3D3Q (DOS/Basic coldstart) and 3D0G (DOS/Basic warmstart) 
should be used instead. 

Control-P and Control-K are the equivalent to the DOS pr# and in# commands. 
Avoid trouble and use the DOS versions. 

Two more infrequently used Monitor commands are I(nverse) and Pi(ormal), 
These commands affect the way characters are printed. They work just like their 
Applesoft brethren, Pi(ormal ) is also often used to separate several commands on a 
single command line, much like the colon is used in Applesoft. We used it that 
way ourselves last month in line 500 of the Lam Technique demonstration 
program (page 13). And we use it that way again momentarily. 

Monitor magic with bells. Hexadecimal arithmethic is easy with the Monitor — 
if you are willing to limit your questions to two digits and can put up with two-digit 
answers. Watch this: 

*2F+80 
= Q F 

*90-2F 
=51 

*30-90 
=F0 

Only addition and subtraction work. Multiplication and division are notsupported. 

The Monitor includes commands that allowyou to move a range of memory to a 
new location or to compare two ranges of memory with each other and print the 
differences. The format for these commands is [destination] < {start}.[end} fol- 
lowed by either a M(ove) or V(erify) command character. Note how the less-than sign 
forms a little arrow that graphically displays which way the bytes will be moved. 
Here's how you use them: 
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*800<3D0.3FFM 



*800<3D0.3FFV 



*9E51<3D0.3FFV 
03F2-BF (4C) 
03F3-9D (G5) 
03F4-38 (FF) 



{moves the $3D0-$3FF range to SB00-J82F.) 

(verify that the move took piace--no response 
means that it did.) 

(compare the J3D0-I3FF range to $9E51-$9EB0. ] 
(discrepancies: 

number after dash is value at address shoun 
number is parantheses is value at corresponding 
address in comparison range.) 



The first line above demonstrates the M(ove) command. This command copies 
an image of the $3D0-$3FF memory range at $800-($82F). The image at $3D0 is left 
unchanged, although this is not always the case, as we'll see shortly. 

The second line demonstrates the V(erify) command. Here we ask the Monitor to 
compare the $3D0-$3FF memory range with what's at $800. It does so and reports 
all discrepancies. Since our move command just made these ranges match, there 
are no discrepancies to report 

The third line compares the $3D0-$3FF range with a range of memory inside 
DOS 3.3 at $9E51-$9E80. The two areas should be similiar, since Uncle DOS moves 
what's at $9E51 to $3D0 whenever a disk is booted, As you can see, three bytes are 
different The number after the hypen shows the value at the address displayed 
on the screen; the number in the parentheses shows the corresponding value in 
the range being verified. 

Now, consider what happens when the range of memory we are moving 
overlaps the range of memory we are moving to. If we are moving a memory image 
toiler, the move will take place normally. In the process, however, the overlapped 
part of the original image will be destroyed. 

When we move a memory image higher, on the other hand, an interesting thing 
happens. The portion of the image that does not overlap is repeated throughout 
the new range. You can quickly fill a range of memory with a specific value or pattern 
of values, for example, like this: 

*2000:FF N 2001<2000.200EM (Put FF at 2000, use Nformal ) as a command 

separator, M(ove) contents of 2000-200E to 2001. ] 



*2000.200F (Display neu contents of 2000-200F. ) 
2000- FF FF FFFFFFFFFFFF 
200B-FFFF FFFFFFFFFFFF 



The 2000:FF initializes the first byte of the range. The /Y tells the Monitor we are 
done with the memory change command and now want to enter another com- 
mand. The 200K2000.200EM moves the value now at byte 2000 into bytes 2001 
through 200F. 

The generalized format for the M(ove) command used in this way— when length 
indicates the length of the pattern to be repeated — is: 

{start+length} < {start} . {end-length} M 

The machine language command 20 DD FB will beep your Apple's speaker. Want 
to hear a thousand beeps? Try this: 

2000:20 DD FB N 2003<2000.2BB4M N 2BBB:S0 N 2000G 

That command line only takes about 114 seconds to execute. The 2BB8;60puts 
a machine language command at the end that returns us smoothly to the Monitor. 
Try 2000L Then try LLLLLLLL Amazing stuff. 

Or perhaps you'd prefer: 



*N FBDDG 34:0 



(put a space after the zero, before you press return) 



This trick creates a repeating command. Start the line with a single letter 
command, end it with 34:0(space). This pokes a zero into byte $34, which causes 
the Monitor to start executing the line over again at the beginning. If you want to 
start beyond the beginning, replace the zero with the number of the character you 
want to start with, minus one. 

Enough tricks. The point is that a familiarity with the Monitor, which is available 
in every Apple II ever built {and few other kinds of computers), gives you the 
power to control your machine at a very elementary level. The box on the previous 
page summarizes the Monitor's commands. 

Help for the absent-minded 

Absent-mindedness is a common fault especially around here. Conse- 
quently, we have a great deal of sympathy for those who manage to destroy 
important files by mistake. 

Word processing and spreadsheet files are particularly vulnerable. The prob- 
lem is that most programs' save and load commands are easily mixed up. A 
frequent cause of file loss is that a user absent-mindedly saves a blank screen 
over the top of a valuable file. Listen carefully on any clear evening and you will 
hear crys of file-loss anguish emanating from chimneys in most major cities. 

However, if the word processor or spreadsheet program uses DOS 3.3 text files, 
the lost data is easily recoverable. This is because DOS 3.3 doesn't remove the 
old file from the disk. Instead the new contents are written over the top of the old 
contents and an end-of-file mark (control-©, hex $00) is placed at the end of the 
new stuff. If the new contents consist of nothing (a blank screen), only one 
character of the original file is destroyed (the one under the new end-of-file mark). 
To recover the file, all you have to do is replace that file-ending zero with 
something else. 

Typically this is done using a disk-edit utility. I once used this technique to 
recover a large section of a friend's Masters Thesis and prevented a potential 
suicide. The technique requires some expertise, however. 

A better way, once you get DOS 3.3's append command working (see the back 
page of this letter) is to let append find the end-of-file mark, then overwrite it with 
a carriage return. When the file is reloaded into the word processor or spread- 
sheet it will burst forth virtually unscathed (damage to word processor files will 
be at the beginning; damage to spreadsheet files will be at the end). Here's a 
program that uses this trick. Go out and save a few lives with it 



10 REM 



*** Phoenix *** 



100 HOME : VTftB 12 : Di=CHR$(4) 

110 PRINT "PLEASE INSERT DISK WITH LOST FILE. " 

120 PRINT " WHAT IS THE NAME DF THE FILE?" 

130 PRINT 

140 INPUT "";F$ 

150 PRINT DS;"UNL0CK";F$ : REM Create error if file-not-found. 
1G0 PRINT D$;"APPEND";F$ : REM Move file pointer to end-of-file marker, 
170 PRINT D$;"WRITE";FJ : REM overwrite marker with a <return>. 
175 PRINT 

180 PRINT D$;"CL05E";F$ 
190 PRINT "FILE FIXED! " 



: REM Rest of file magically reappears. 
END 
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Loose Ends 

Last month I left some questions unanswered, and 
a couple of them still have me puzzled. But readers 
have helped with answers to some. 

Regarding AppleWorks and non-Apple printers 
and interface cards: Apple has released an updated 
version of AppleWorks to dealers that solves this 
problem. Dealers are supposed to update your orig- 
inal disks for free. Call ahead to make sure your 
dealer has the update. My source on this one highly 
recommends you insist on talking to the dealer s 
technicians, rather than salespeople, for this and all 
similar problems with Apple programs and equip- 
ment It's the technicians that Apple notifies about 
such bugs and how to fix them. My source adds that 
the ProDOS version of AppleWriter has the same 
problem—dealers have also been issued a fix for 
this. 

One of last month 's letters asked how to do an 80- 
column screen dump. In the response to that letter, 
J mentioned that my printer garbled when I printed 
while the 80-column screen's even columns, which 
are stored in auxiliary memory, were turned on. But 
I didn't know why. The reason occurred to me as 
soon as the letters were printed. Printer interface 
cards, like most Apple II peripherals, use a small 
amount of memory inside the text screen. This area 
is usually called the scratchpad area, or the screen 
holes. When the even columns are on, the scratchpad 
area the interface card is using disappears; thus the 
problems. 

If you need a faster 80-column screen dump, 
delete line 505 from last month s program (page 15), 
remove the in line 340, change line 560 to 
"PRinTL$+CriR$(PEEr\(ADR)h", and remove the 
from line 580. 

Remittance bug revealed 

Tom, try this program: 

10 Yl=24 : REM 1 year subscription price 

20 V2=44 : REM 2 year subscription price 

30 PRINT £Y1*2)-Y2 

RUN 

4 

Why do your bills say a two-year subscription is an 
savings? Philip Straus 

Philadelphia, Fa. 

My error. Abby, Open-Apple's spokeswoman, 
nearly resigned when she saw your letter. She 
agreed to continue with Open-Apple only if I tacked 
a couple of extra months onto the subscriptions of 
those of you who actually paid $44, and I've done so. 



Input comma no garbage 

I have an addition to the Selective String Preserva- 
tion technique for avoiding garbage collection that 
you wrote about in the January issue (pages 4-5). 
Here's a routine that replaces Applesoft's input com- 
mand so that commas are allowed, Normally rou- 
tines that use get like this cause garbage collection 
to occur frequently, but this one doesn't create any 
more garbage than input itself does. As written, the 
routine also filters out control characters. 

50 SL=PEEK(U1) ; : SH=PEEK(112) * 
.51 IS-" " 

52 FOR C*l TO 255 

53 : GET AS : PRINT 

54 : IF R5C(A$) = 13 THEN C=255 : GOTO 5G 

55 : IF RSC(R$) > 31 THEN I$=I$+A$ 
5S NEXT 

57 PRINT 

58 POKE lll.SL : POKE 112,SH 

>59 I$=HI0$(I$,1) # 

1$ is made permanent by line 59, which makes a 
new copy of it after the pointers at 111 and 112 have 
been changed to erase the temporary copies of A$ 
and 1$. They will be overwritten and won't cause 
garbage collection. 

Jim Parr 
Bloomington, III. 

Fast garbage bugs 

I tried the fast garbage collector published in the 
January 1981 Call -APPLE, and mentioned in your 
January issue. I had some trouble getting it to work. 
After studying the code, I discovered some bugs. The 
subroutine NZTAB, which zeros out the address table, 
ends with a JMP to FriDVARZ not an RTS. Conse- 
quently, the initial call to NZTAB should be a JMP not 
a JSR, and should occur just before FMDVAR2, 
between lines 63 and 64, not at line 59. 

In addition, the Y register should be cleared when 
a new address is placed in INDEX. Add a LDY #0 just 
before lines 69 and 79, 

Steve Hunt 
Cambridge, Mass. 

77iere was one more bug. Val Golding, editor of 
Call -APPLE, when the original program was pub- 
lished, tells me he misspelled the author's name and 
I reprinted his mistake. The author's name is Handy 
Wigginton. It's an important name to spell right, as 
Randy has been involved with Apple since, as a 16- 
year-old in 1976, he hitched rides to homebrew 
Computer Club meetings with Steve Wozniak. tie's 
been one of Apple's most prolific wizards ever since. 

Rana, A.RP.LE, Abacus 

Your February editorial about DOS 3.3 was on the 
mark, and raises an interesting question, How do 
people who make double-sided drives (e.g. Rana Elite 
II) make them compatible with DOS 3.3? Do they 
define a logical track to be two physical tracks— 
presumably one on each side of the disk? This would 
create, in effect, tracks with 32 sectors, which you say 
DOS 3.3 can handle. I imagine this scheme would not 
require any repositioning of the head to read all data 
from any logical track. 

Speaking of Rana, while I still see their products 
being advertised by a number of mail order houses, 
they appear to have completely discontinued their 
own advertising. 1 was greatly interested in their 
8086/2 unit since it provides MS-DOS compatibility 
for the Apple as well as high capacity drives usable 
under all four operating systems that run on the 
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Apple (DOS 3.3, Apple Pascal, CP/M-80, and ProDOS). 
I obtained a pre-publication copy of the 8086/2 man- 
ual, and actually saw a unit once at a dealer, though 
like most dealers he couldn't answer a single ques- 
tion. A friend of a friend has one, and while the level 
of compatibility with the IBM PC is not as high as one 
would like, he reportedly is satisfied with it I wrote a 
lengthy letter to Rana asking a number of questions 
about six months ago and never got an answer. I'm 
still interested, I still have all those unanswered ques- 
tions and one more besides: How come you don't 
hear anything about a product that once seemed 
destined to sell several hundred thousand copies at 
over $1500 each? 

I would like to call attention to a situation that 1 feel 
is deplorable, especially since it involves a group in 
which I had placed considerable trust and which I had 
enthusiastically recommended to many friends. The 
billing policy of APPLE, (the user group in the Seattle 
area that publishes Call -APPLE, magazine) doesn't 
conform to the standard practices of ethical mail 
order merchandising. On December L I ordered sev- 
eral software packages from them by mail, They 
billed my credit card on December IX and as of late 
January they had not yet shipped me anything and 
refused to make a commitment on when they would 
ship. Standard practice is to bill only at the time 
shipment occurs. I like to think of AP.P.LE. as a group 
of the Apple community's most upstanding citizens, 
so this incident comes as a grave disappointment 

On a more pleasant note, 1 would like to recom- 
mend the 128K RAM card manufactured by Abacus 
Enterprises, P.O. Box 1836, Detroit, MI 48231 (313- 
524-2444 voice, 313-524-0238 300 baud). I think it 
is a super product and the service provided by Aba- 
cus is outstanding. The hardware is unique in that an 
external switch allows the card to emulate either the 
Saturn or Legend bank switching protocols. The card 
can be write protected, also by means of an external 
switch. Abacus has released a software package 
called Back-to-Back that allows swapping images of 
the lower 48K of RAM into and out of the 128K card 
at the press of a button. This makes it possible to 
suspend operaton of one program, toggle to a 
second and, at the press of a button, resume opera- 
tion of the first right where you left off. Abacus also 
provides a very easy-to-use RAM disk emulator for use 
with DOS 3.3. 

Dan Strassberg 
Arlington, MA 

Rana provides a highly modified version of DOS 
5.3 with its high capacity drives. It actually has two 
Volume Table Of Contents sectors on each disk and 
is consequently incompatible with lots of stuff, 
including ProntoDOS. / picture Rana as a compamy 
that tries just a little bit too hard. Their products do 
wonderful things nobody else can do, but at the 
price of compatibly problems that keep them out of 
the fast lane. . 

Like you, I've bought tons of stuff from APPLE, 
over the years and have recommended them in this 
letter and other places, like you, I recently had an 
order delayed. The folks in Seattle say they ran into 
unexpected problems with a cross-town moue they 
made in late December, and that is why customers 
are experiencing delays. 

As a certified mail order junkie, I commend you for 
having the good sense to pay by credit card, and I 
recommend that everyone buy mail order goods 
that way when possible. If APPLE, still hasn't 
shipped, complain to your credit card company and 
let them handle it. That will get APPLE'S attention. 
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A charming difference 

You say the S.H. Lam technique for entering Mon- 
itor commands from inside Basic programs (Feb 
pages 12-13) works from within a subroutine. But the 
same routine appears on the Beagle Bros Pecks, 
Pokes and Pointers chart and the chart says it 
won 't work within a subroutine. Who's right? 

Uncle Louie 
San Diego, Calif, 

Both of us. In the version shown on the Beagle 
Bros chart, D823G is tacked onto the end of the 
Monitor command string, in the Open-Apple ver- 
sion, D9C6G is tacked on. Both formulae cause the 
Monitor to jump to charmed spots within Applesoft, 
however, one spot is more charmed than the other 
and works from within subroutines. 

Who needs OPEN 

In January's Digging Into DOS (page 2), the 
straightforward way you give to read a text file con- 
tains an extra step. For reading text files, open is a 
redundant command. If you want to open abc and 
read from it, just print d$;"read abc". 

Looking at the code for read, it's easy to see why 
open is not required. The first thing DOS does in read 
is to check whether the file is open. If not it opens it 
I no longer use the open command for reading text 
files. An added advantage is that a file is not created 
if it doesn't already exist- you'll get a file not found 
error instead. 

The write command works in a simliar manner 

Charles H. Putney 
Shankiil,Ca Dublin, Ireland 

You are absolutely right. The only problem with 
this trick is that Apple never documented it; conse- 
quently the ProDOS developers apparently didn't 
know about it; consequently it doesn't work with 
ProDOS. 

Disk free space 

In the March 1984 issue of Softalfcyou wrote about 
the DOS 3.3 Volume Table of Contents and you 
printed a Basic program to calculate the number of 
free sectors on a disk. I have used that program as a 
subroutine in a larger program, which is now running 
under your ProntoDOS. I am getting very limited by 
having DOS at 48K, and the program is causing 
Applesoft's garbage collection to occur very fre- 
quently. I would like to use your DOS-UPprogram on 
the ProntoDOS disk to move DOS up to the top 16K. 
Can you tell me where DOS's VTOC buffer is located 
afterDOShasbeenmoved? Robertn y berg 

Tucson, Ariz. 



it's 16,384 ($4000) bytes higher than before, but 
that information won't help you much. If you look at 
that address range from within a Basic program, 
what you'll see is the machine language code of 
Applesoft itself, not DOS. If you turn the upper J6K 
of memory on so you can see DOS, your Basic 
program wilt crash because Applesoft will disappear. 

You have to peer at the high reaches of memory 
with an assembly language routine, A better 
approach to solving your problems may be to use 
the garbage collection tips published in this issue 
and in January 's. 

Although I 've written a program for moving DOS to 
the upper 16K of memory and although many, many 



people use fit my experience has been that moving 
DOS often causes as many problems as it solves. If 
you are writing pure Basic with no assembly lan- 
guage routines and no fancy tricks, a relocated DOS 
works great But as soon as you try to fine tune 
things, problems begin to occur. 

Another approach to consider is to switch to Pro- 
DOS. This won't increase the amount of memory 
available, but it gives you fast garbage collection and 
a chain command that's quick and easy to use. On 
128K machines you'll have the ProDOS /HAM disk; 
you can use it to keep the chained parts of your 
program available for quick access, finding the 
number of free blocks on ProDOS disks is pretty 
easy. Pish it out of the catalog, which you can open 
and read like any other file. 

80-columns & machine language 

How do you activate or deactivate Apple's 80- 
column card from within a machine language pro- 
gram? After the card is activated, what routine is used 
to write a character to the screen? 

Tom Carlin 
Cleveland, Ohio 

First the easy stuff. Once you have the card turned 
on, you send characters to it from machine language 
by loading the character into the A register and 
doing a JSR to GOVT ($FDED)— exactly the same 
procedure as used in 40 columns. To deactivate the 
card, simply use this procedure to print a Control-U. 

Other fancy things you can do by sending control 
characters to COUTwtth 80-cotumn mode activated 
are: 

control ASCII name action 
chr vrai 

cursor moving codes/none clear any part of the screen 
H $08 backspace left one character 

\ $1C fud. space right one character 

J $0A line feed dour, one line 

H $0D return left edge and down one 

Y $19 home upper left corner 

text moving codes/neither moves the cursor 
U $17 scroll up text moves up 

V $16 scroll down text moves down 



screen clearing codes 

L $0C clear uhole screen 

K $0B clear ED5 cursor to end of screen 

] $1D clear EDL cursor to Bnd of line 

Z SIR clear line clear line cursor is on 



other codes 



D 


$0F 


inverse 


begin inverse display 


N 


Stt 


normal 


begin normal display 





ill 


40-column 


begin 40-column display 


P 


112 


80-column 


begin B0-column display 




$15 


quit 


turn 80-column card of f 



Turning the card on varies depending on whether 
you want DOS to remain connected or not. If you are 
using DOS 3.3 and you leave it connected, Uncle 
DOS will respond to commands that are preceeded 
by a return and a eontrol-D, just as he does from 
Basic. Simply send the command to COUTone letter 
at a time, in this situation, you turn on the 80-column 
card by sending DOS the command YR#3. 

ProDOS does not respond to commands sent to 
COUT from assembly language programs. You must 
use the ProDOS machine language interface, or, if 
your machine language program is CALLed from a 
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Basic program, you can poke the command string 
into the keyboard input buffer at $200 (don't forget 
to put a return at the end), and do a JSR DOSCMD 
($BE03) to execute it Once again, use FR#3 to turn 
on the 80-column card. (CAUTIOH: several com- 
mands, including read, write, and append, don't 
work correctly when initiated with DOSCMD.) 
If you don't need DOS, turn on the card like this: 

R9 03 LDfl B$03 B0-CDlumn slot number 

20 95 FE JSR OUTPORT do a pri ui th SFE95 

A9 60 LDA tt$80 return 

20 ED FD JSR COUT print it with SFDED 

Big Boy Data Managers 

Is there a good database manager for the Apple lie 
that will accomodate 15-20 thousand names and 
cross reference them with about 25 categories? 

Lowell Levinger 
Inverness, CA 

/ haven't tried all of the database programs avail- 
able for the Apple, but of the ones I have used, the 
database manager in AppleWorks is my run-away 
favorite. I think it's the strongest of the three pro- 
grams that comes with AppleWorks. It won't do 
what you want, but keep reading. 

After trying for a couple of weeks to set up Open- 
Apple's subscriber records with a high-powered" 
Apple II database manager (and getting nowhere), I 
turned to AppleWorks and had the whole thing set 
up, complete with several kinds of status reports, in 
a single afternoon. 

Since then I've written some Basic programs that 
read AppIeWorks-generated text files and do spe- 
cial manipulations (such as, while printing monthly 
mailing labels, also printing an invoice label for the 
remittance envelope If an account is unpaid). Apple- 
Works' ability to generate standard text files holding 
data it has sorted, selected, and formatted is a very 
strong feature of the program. 

If you have a ile, you should have AppleWorks 
anyhow, so if I were you I'd start with it It's quite 
easy to use and is a good place to organize and 
practice using a database. It won t be your final 
solution, however -the great limitation is that you 
won't be able to get anywhere near 15,000 records 
in a single file. Using a Ik you'd probably need about 
30 separate files to hold that much data. There is a 
possibility this wouldn't be a problem for you, but 
that's unlikely. 

By starting with AppleWorks, however, you'll 
have a clearer idea of what you want to do and how 
to do it. Its great advantages are speed, ease of use, 
and clarity. Sorting a 500 record file takes less than 
10 seconds. You can move from record to record 
instantaneously. You can display a whole screenful 
of records at the same time and scroll through them. 

Once you see what AppleWorks can do with a 
sample of your data, you'll be in a better position to 
judge other database managers by their instruction 
manuals. Given ProDOS, there is no theoretical rea- 
son why a lie shouldn't be able to handle a database 
as large as yours. I would recommend a hard disk or 
other high-capacity storage device to avoid finger 
blisters caused by constantly opening and closing 
disk drive doors, however. 

It's also necessary to consider how often the 
records in your file are to be updated. If the records 
consist of something like daily meal requests for 
15,000 people, the Apple He will be woefully inade- 
quate simply because one person working at one 
computer can't update that many records in one 
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day. If the records are updated yearly, on the other 
hand, a single person using good software and a He 
will be able to manage the data and do lots of other 
stuff, too. Always keep in mind the limits of what one 
person using one computer can do when organizing 
this much data. Sometimes you just can 't handle it 
without going to some kind of multi-user system. 

Another big boy 

A company here in Texas called Applied Engineer- 
ing has a card for the Apple lie that can expand 
memory to as much as 1 megabyte (1024K bytes). 
The company also offers a patch for AppleWorks 
that will allow the user to have an 800K desktop. That 
should quell some of the blithering about how 
limited AppleWorks is due to memory restraints. 

For the price of an IBM PC and Lotus XY2 a smart 
user could have a lie with 1 meg of RAM, Apple- 
Works, and the Sider hard disk drive. There might 
even be enough left over to buy a joystick, This would 
turn the lie into a real mother-hummer. It might also 
make a few of the PC parrots choke on their crackers. 

Gary Maddox 
Weatherford, Texas 

you think just like I do. I have one of Applied 
Engineering's cards on order —look for a complete 
report here in a month or two. 

The DOS 3.3 append challange 

Could you discuss the bug in the append com- 
mand of DOS 3.3? When the file being appended to 
ends at the end of a sector, it doesn't work. I have 
discussed this with Apple, but they had no help to 
offer. Is there a way to fix this? 

ferd Q. Fender 
Qlenview, 111. 

005 3.3's append command graphically demon- 
strates the difficulty of getting all the little bugs out 
of complex software. Apple has officially modified 
append three times and still doesn't have it right. I 
have officially modified it once and didn't get it right 
either. So it's with some fear and trembling that I 
enter this discussion. 

Append is very similar to the DOS open command. 
You use it to get a specific text file ready for reading 
from or writing to. When you use open, DOS aims its 
position-in-file pointer at the first byte of the file. 
When you use append, on the other hand, DOS alms 
its pointer at the byte just beyond the last byte in the 
file. If your next action is to write to the file, what you 
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write will start at the end of the file, rather than the 
beginning, and thus will be appended, or added to, 
the original file. Of your next action is to read from 
the file, you'll get an end of data error.) 

Unlike ProDOS, DOS 3.3 doesn 't keep a record of 
how long text files actually are. When you issue an 
append, DOS 3.3 simply starts reading the file and 
continues until it comes across a byte holding a zero, 
By definition, the first zero byte encountered marks 
the end of the file, however by the time DOS 
retrieves the zero, the position-in-file pointer is 
aimed at the next byte— the byte beyond the zero, 
So DOS next executes an internal position command 
to back up the position-in-file pointer by one byte. 

So far this all seems pretty simple, right? What I've 
just described is exactly how the DOS 3,2,1 append 
command worked. But there's a bug here. While a 
zero byte in a file is the main method for marking the 
end of the file, it's also possible for a file to simply 
have no more sectors. This happens whenever a 
file's length is a multiple of exactly 256 bytes. The 
final sector in the file will be completely filled with 
data, there will be no more sectors assigned to the 
file, and there won't be a zero anywhere in sight In 
this situation, the position-in-file pointer doesn't get 
bumped up an extra notch, yet append insists on 
bumping it back a notch as usual. The effect is that 
the final byte of the original file is overwritten by the 
appended material whenever a file ends exactly on 
a sector boundry. 

When the original version of DOS 3.3 was released 
(around here I call it DOS 3.3.0), a patch was added 
to take care of the problem. Unfortunately, what 
should have been a simple test in the append routine 
to determine whether the position-in-file pointer 
should be reset or not became a 74 byte patch of 
amazing complexity, however, it fixed the bug.Yet, 
like many patches, it added a new bug of its own. 
This bug is quite obscure -let's just say that when 
the stars are right, the DOS 3.3.0 append command 
will still fail to work. 

It was about this time that yours truly wrote 
ProntoDOS for Beagle Bros. Much of the room for 
the ProntoDOS routines came from removing 
Apple's 74-byte patch. I solved the major append 
bug and got rid of the exotic one with just a few bytes 
of code. I bragged that I had solved the DOS 3.3 
append problem. Such fatheadedness is always 
inappropriate for assembly language programmers. 

For there was yet another bug. The position rou- 
tine that DOS calls to notch back the position-in-file 
pointer doesn't work correctly if the file being 
appended to is longer than 32,767 bytes. Art 
Schumer described the bug in an article that 
appeared in the August 1982 Call -APPLE., page 57. 
(It's also in Call -APPLE. In Depth #3: All About DOS, 
page 191) Unfortunately, I didn't come across the 
article until several months after I had finished 
ProntoDOS. 

The folks at Apple saw the article, however, and 
when they released a new version of DOS 3.3 for the 
He in January 1983 (I call this version DOS 3.3eh 
they fixed this bug. Rather than using position to 
notch back the pointer, the lie version modifies the 
pointer by hand. Apple also added 13 additonal 
bytes of code to fix the more exotic bug in their 
original 74-byte patch. 

Was everybody happy? Does this story have a 
pleasant ending ? hot yet, gentlepeople; Apple 's new 
patch made things even worse. 

The position-in-file pointer within DOS is three 
bytes long, One byte is aimed at the byte offset 
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within a sector. The next byte is aimed at the sector 
number— until it hits 256 anyhow. Then the third 
byte comes into play and the second byte starts over 
again at zero. 

Apple s DOS 3.3e patch only adjusts the lowest of 
these three bytes. When a file-ending zero appears in 
the final byte of a sector, the middle byte of the 
pointer will have been advanced to point at the next 
sector. But since the patch doesn't decrement the 
middle byte, the position-in-file pointer ends up 
aimed 256 bytes beyond where It should be, DOS 
3.3e's append fails completely once every 256 
times. 

In September 1983 Apple released a third version 
of DOS 3.3. Apple's people said this would be the 
final update to DOS 3.3, since ProDOS would be 
Introduced within a few months. (I call this final 
fairly-fixed version DOS 3.3f). This version expands 
the 3.3e patch to decrement the middle byte of the 
position-in-file pointer correctly. However, it still ne- 
glects to decrement the high byte of the pointer 
when necessary; consequently even this version has 
an append that will fail if you try to add something 
to a file that's exactly 65,535 bytes long. 

The program that follows fixes all the append bugs 
I know about in all three versions of DOS 5.3. Enter 
and run the program and test the results on a few 
files. If everything works, you can initialize a new 
disk and the changes will become a permanent part 
of the DOS on your new disk. With standard DOS 3.3, 
the patch overlays a portion of Apple's useless 74- 
byte append patch and thus requires no additional 
space. 

ProntoDOS, however, already uses that area for 
something else. If you are a Pronto user, start with 
an unmodified copy fresh from the original Beagle 
Bros disk. Then enter, run, and test this program, 
After the append patch has been added, you can use 
Pronto Update to add most, but not all, of the other 
ProntoDOS enhancements and to update your 
disks. Don't run this program after making other 
enhancements to ProntoDOS or trouble could 
result 

(If you are a DiversiDOS user, incidentally, your 
append command already works correctly.) 

10 IF PEEK (978)0157 

THEN PRINT "48K 005 3.3 NOT ACTIVE." : END 
15 PRINT "Installing APPEND patch..." 

20 REM identify DOS type 

21 ID=PEEK(4G725) 

22 IF I0=1GS THEN DT$="DOS 3.3.0" : GOTO 30 

23 IF ID=1BG THEN 0TS="D0S 3.3e" : GOTO 30 

24 IF ID=1BZ THEN DTi="DOS 3.3f" : GOTO 30 

25 IF ID=20G THEN 0TS="ProntoD05" : GOTO 40 
2G PRINT "RCTIVE DD5 NOT RECOGNIZED. " : END 

30 C$="fi2fil:92 BG~ : GOSUB 500 
32 CS="AGB3:0A" : GOSUB 500 
34 AJ*"B692" : GOTO 50 

40 C$="AGC0:B3 BG" : GOSUB 500 
44 flI="BGB3" 

50 C$=AS+":B0 19 AC EG B5 00 10 AC E4 B5 
D0 08 AC E5 B5 F0 0C CE E5 B5 
CE E4 B5 CE EG B5 20 7E AE G0" : GD5UB 500 

52 PRINT DT$ ; " currently active." 

54 PRINT "APPEND now works with any size file." 

5G END 

500 Ct=C$+" N D9CGG" 

510 FOR 1=1 TO LEN (CI) : 

POKE 511+1, ASC(MID$(C$,I,1))+12B : NEXT 
520 POKE 72,0 : CALL -144 
530 RETURN 



